home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / new1091.zip / NEW.DOC < prev    next >
Text File  |  1991-10-15  |  6KB  |  184 lines
  1.                                      NEW
  2.  
  3.     Copyright (c) 1989, 1990, 1991 John R. Pulliam    Version 10/15/91
  4.  
  5.         Released to the Public Domain for non-commercial use and for
  6.     commercial use by permission of the author.
  7.  
  8.     PURPOSE
  9.  
  10.     NEW is a utility program that displays a list of the files in
  11.     the specified directory that were created since 00:00 hours of
  12.     the current day, or optionally since midnight of any earlier day.
  13.  
  14.     All files with attributes of Hidden, System, Read-Only, Archive,
  15.     Volume Label and Directory are displayed along with normal files.
  16.  
  17.     The total number of files, total number of bytes in those files
  18.     and the free space on the drive are displayed at the end.
  19.  
  20.     NEW is intended for use on IBM Compatible computers using any
  21.     versions of PC/MS-DOS of 2.0 or higher.
  22.  
  23.     This program is patterned after the program by the same name
  24.     written by Jay Jervey, which is a great utility written in
  25.     Microsoft C.  No source code that program or of any other program
  26.         and no disassembled code were used in this program.
  27.  
  28.     This program was written just as a programming exercise and
  29.     because I wanted to define a "new" day as starting at 00:00 hours
  30.     rather than at 06:00 hours, as was done by others.
  31.  
  32.  
  33.     RUNNING NEW
  34.  
  35.     NEW is invoked by entering input commands as shown below:
  36.  
  37.        "NEW"
  38.         The current day, disk drive and directory is used.
  39.  
  40.        "NEW/x d:"
  41.         The date used is "x" days prior to the current day. The
  42.         default is 0, the current day since midnight.
  43.         The drive used is "d:"
  44.         The default directory on drive "d" is used.
  45.         A file name of *.* is used by default.
  46.  
  47.        "NEW/x d:\dir\file.ext"
  48.         The date used is "x" days prior to the current day,
  49.         as above.
  50.         The drive used is "d:"
  51.         The directory used is "dir" on drive "d".
  52.         The file name used is "file.ext". Wildcards * & ? may be
  53.         used in the file name and extension only.
  54.         A directory can not be specified unless the drive is
  55.         also specified.
  56.  
  57.  
  58.     FOR THE PROGRAMMER TYPES
  59.  
  60.     There is a Conditional Assembly variable, DTYPE, provided in
  61.     the source code that changes the format of the date display.
  62.     The program must be re-assembled if you want to change this.
  63.  
  64.     In case you do not have the Microsoft Assembler, two copies of the
  65.     executable file are provided with the names of NEW1.COM and NEW2.COM.
  66.     The one you prefer using can be renamed to NEW.COM.
  67.  
  68.     NEW1.COM gives the dates in the mm-dd-yy format, (11-26-90 for
  69.     November 26, 1990) as below:
  70.  
  71.     NEW - Version 10/15/91 - J. Pulliam
  72.  
  73.     Directory of C:\MASM since 00:00, 10/14/91
  74.  
  75.     X        ASM     17609   10-14-91   08:29:48  ARC
  76.     NEW      ASM     41907   10-15-91   12:25:20  R-O ARC
  77.     HEX2ASC  ASM      1843   10-14-91   08:29:40  ARC
  78.     ANS      BAT       337   10-14-91   16:29:32  ARC
  79.     INSTR    ZIP     14093   10-14-91   08:30:50  ARC
  80.     NEW2     COM      2374   10-15-91   12:26:30  ARC
  81.     ANL      BAT       339   10-14-91   16:31:54  ARC
  82.     NEW      1       39172   10-14-91   17:45:06  HDN SYS ARC
  83.     ABCDEFGH     <DIR>       10-15-91   16:11:24  DIR
  84.     ABCDEFGH ABC <DIR>       10-15-91   16:11:24  DIR
  85.     NEW      3       40629   10-15-91   14:50:56  ARC
  86.     X        COM      1072   10-15-91   17:15:00  R-O HDN SYS ARC
  87.     NEW      4       41088   10-15-91   19:14:16
  88.     NEW      DOC      5557   10-15-91   12:38:34  ARC
  89.     NEW1     COM      2303   10-15-91   12:35:16  ARC
  90.  
  91.         Total of 208323 bytes in 15 files
  92.  
  93.           Total of  1390592 bytes free
  94.  
  95.  
  96.     NEW2.COM gives the dates in the dd-Mon-yy format, ( 3-Jun-91 for
  97.     June 3, 1991) as below:
  98.  
  99.     NEW - Version  10/15/91 - J. Pulliam
  100.  
  101.     Directory of C:\MASM\X since 00:00, 15-Oct-91
  102.  
  103.     .            <DIR>       15-Oct-91   16:11:24  DIR
  104.     ..           <DIR>       15-Oct-91   16:11:24  DIR
  105.     ABC      ABC         1   15-Oct-91   16:11:48  ARC
  106.     Y            <DIR>       15-Oct-91   19:10:15  DIR
  107.     ABC      MSS        33   15-Oct-91   20:35:58  ARC
  108.     CDE                 33   15-Oct-91   20:35:58  ARC
  109.     12345678     <DIR>       15-Oct-91   11:29:40  DIR
  110.     12345678 AAA <DIR>       15-Oct-91   11:29:42  DIR
  111.     12345678 MSS       170   15-Oct-91   11:31:52  ARC
  112.     AAAAAAAA           170   15-Oct-91   11:32:34  ARC
  113.     PW       SWP   1024128   15-Oct-91   12:06:58  ARC
  114.  
  115.         Total of 1024535 bytes in 11 files
  116.  
  117.           Total of  1353728 bytes free
  118.  
  119.  
  120.     An ERRORLEVEL of 0  is returned if NO error occurs.
  121.     An ERRORLEVEL of 1+ is returned if an error occurs.
  122.  
  123.  
  124.     The source code for NEW is being distributed for your own use.
  125.     A lot of work went into writing this program so please do not
  126.     remove any credit lines and try to pass it off as your own work.
  127.  
  128.     You may make any modifications you wish for your own use, however
  129.     the modified program may NOT be distributed to others without
  130.     my permission.
  131.  
  132.     This program is made available for use with no liability assumed by
  133.     the author.
  134.  
  135.     MS-DOS, PC-DOS, IBM, etc. are copyrighted by well known companies.
  136.  
  137.  
  138.     CHANGES/BUG FIXES
  139.  
  140.     This version is released as NEW1091 and replaces the previous
  141.     version of NEW0691.  Changes made were:
  142.  
  143.     1. Changed to display the extension of a sub-directory name,
  144.            such as "SUBDIR.A01".
  145.  
  146.  
  147.     Changes made in release NEW0691.
  148.  
  149.     1. Changed to prevent displaying null file sizes & dates after
  150.        reporting INVALID ARGUMENT or INVALID DIRECTORY error messages.
  151.     2. Changed to prevent incorrectly trying to display a date that
  152.        is older than 1-Jan-80.
  153.  
  154.  
  155.     Changes made in release NEW0291.
  156.  
  157.     1. Changed to display the volume label if one exists on the
  158.        specified drive & the root directory is specified.
  159.  
  160.  
  161.     Changes made in release NEW1190.
  162.  
  163.     1. Changed to allow a file name to be used on the command line.
  164.     2. Changed to blank out the size field for directory names.
  165.     3. Made minor changes to the format of each displayed line.
  166.  
  167.  
  168.     Changes made in release NEW1089.
  169.  
  170.     1. Correction made to allow the drive to be entered in lower case.
  171.     2. Correction made to report an invalid directory error.
  172.     3. The free space available on the drive is now shown "up to 100MB".
  173.     4. The file attributes are now displayed.
  174.  
  175.  
  176.     If you find any errors or have any suggestions for improvement,
  177.     please contact me at my residence below or on CanCom BBS at
  178.     216/477-3080.
  179.  
  180.                 John Pulliam
  181.                 1324 Cypress Bend Circle
  182.                 Melbourne, Fl 32934
  183.                 407/255-7690
  184.